.pl 29.7c
.\\" $Id: smquick.1,v 1.3 2004/07/11 08:04:47 bhepple Exp $
.TH SMQUICK 1 "Tue Nov 3 1992" "\&\(co Bob Hepple"
.UC 4
.SH NAME
smquick \- quickly create
.B "Screen Manager"
screen definition files from data files.
.SH SYNOPSIS
.B smquick
[
.B \-F
.I separator
]
[
.B \-t
.I tag-field
]
[
.B \-l
.I label\-width
]
[
.B \-f
.I max\-width
]
.B \-T
.B \-e
.I data\-files
.SH DESCRIPTION
.B smquick
scans the data files and makes a best guess at a
.B "Screen Manager"
screen description file according to the fields it finds in each
record type.
It then outputs the screen description file on stdout.
The screen description file can then be
editing and refined with
.BR smcreate (1)
which is part of this suite of programs.
In particular it is wise to
use more meaningful field names in the screen description file than
.B smquick
invents (e.g. use \fIName, Address, etc,\fR instead of \fIField1,
Field2, etc.\fR).
You would also add helpful comments and labels on the
screen file.
.SH OPTIONS
.TP
\fB\-F\fI separator\fR
use
.I separator
as the field separator (as in
.BR awk (1)).
Default is the \fBTAB\fR character.
.TP
\fB \-t \fItag-field\fR
use the
.IR tag-field'th
field as the record-type in a variant record file (a file with
different record layouts for different lines).
The first field is number one.
The default
is zero - i.e. all records have the same layout and the same fields.
.TP
\fB \-l \fIlabel\-width\fR
allot
.I label\-width
spaces at the left margin on the form as space for labels.
Default is 10 spaces.
.TP
\fB \-f \fImax\-width\fR
limit the size of fields to
.I max\-width
characters.
Default is 30.
.TP
\fB \-T
attempt to create tabular (scrolling) screens which will display one
data record per line instead of the usual form which displays one
record per page.
.TP
\fB \-e
make all fields of equal width.
.PP
Note that lines in the data file starting with "\fB#\fR"
are assumed to be comments.
.SH EXAMPLE
The following shows how
.B smquick
takes a data file \fIproject.txt\fR and creates a
.B "Screen Manager"
screen description file ready for editing with
.BR smcreate .
The resulting screen description file is then used to edit the
original data with
.BR smdata .
.RS
\fIsmquick project.txt >project.dat
.br
smcreate project.dat ... fine tune the screen.
.br
smdata project.dat\fR
.SH FILES
.TP
.B *.dat
Conventionally,
.B "Screen Manager"
files have a '.dat' extension although this is not required.
.TP
.B *.txt
Data files - again, this convention is not enforced.
.TP
.SH "SEE ALSO"
Postscript version of these man pages which have screenshots -
probably in /usr/share/doc/scrmgr-X.Y.
.LP
.so smquick.lst
.SH AUTHOR
Bob Hepple <bhepple@freeshell.org>
.SH COPYRIGHT
Copyright \(co 1991-2002 Bob Hepple
